home *** CD-ROM | disk | FTP | other *** search
/ Hottest 6 / Hottest 6 (1996)(PDSoft)[!].iso / software / fredfish / 1100.lha / Programs / Sort / sort.doc < prev    next >
Text File  |  1995-04-12  |  6KB  |  146 lines
  1. sort.doc    sort Version 1.36        by Rüdiger Werner
  2.  
  3. The program and files in this distribution are freely distributable,
  4. but are also copyright (c) Rüdiger Werner. They may be freely
  5. distributed as long as no more than a nominal fee is charged to cover
  6. time and copying costs.
  7. No commercial usage is permitted without written permission from the
  8. author. Everything in this distribution must be kept together, in original
  9. unmodified form.
  10. This program is cardware, that means if you find this program useable or
  11. if you tried it then I'd like to receive a postcard from you.
  12. Of course I'd be very grateful, if you want to donate the author.
  13. The money will be used for a good purpose: I know very well a small indian
  14. boy who needs to be operated quite urgent. The parent have to pay the
  15. operation themselves, but they can't afford it. This is true, really.
  16.  
  17.  
  18. ***********************************************************************
  19. * Notice that the author can't be made responsible for the destroying *
  20. * or lost of data through use of this program. You use it on your own *
  21. * risc. Please read the Doc-file before using.                        *
  22. ***********************************************************************
  23.  
  24. Please contact me if you have any comments or suggestions
  25. or if you simply tried the program:
  26.  
  27.  E-Mail:  rw2@irz.inf.tu-dresden.de
  28.       wernerr@eeetwc.et.tu-dresden.de
  29.  
  30.  Mail:      Rüdiger Werner
  31.       Stresemannplatz 2
  32.       01309 Dresden
  33.       GERMANY
  34.  
  35.  
  36. CHANGES TO LAST VERSION
  37. the -s option now works also in a given range only
  38.  
  39. Description
  40. -----------
  41.  
  42. The program was written for use in Shell only.
  43. It is started either by simply typing it's name (of course it should be
  44. in the current directory or in the path) or by giving additionally switches
  45. and/or the name of the file what should be sorted.
  46.  
  47.  sort [switches] infile [infile 2 ... ] [outfile]
  48.  
  49. By typing 'sort ?' appears a short help.
  50. The specified file is opened and red in the memory. There it will be sorted
  51. and, if the switches were set, manipulated in the required way.
  52.  
  53. Switches:
  54.  
  55. -a    sorting the file in ascending order (it is optional, because default)
  56.  
  57. -d    sorting the file in descending order
  58.  
  59. -e    all lines which are empty will be erased.
  60.  
  61. -E    after sorting all lines which are empty or more than once in a file
  62.     will be erased (of course ONE of these lines is kept in the file).
  63.  
  64. -f[y]    using this option one can specify the first line of a range to be
  65.     sorted. if this option is given, ALL actions are done ONLY within
  66.     this range. to give also the last line is not compelling
  67.     if y is bigger than the number of lines of the internal file
  68.     (all in-read files together) an error-message appears and the
  69.     program is cancelled
  70.  
  71. -g    actually the capitals and small letters are distinguished.
  72.     by setting this switch, they won't be distinguished.
  73.  
  74. -j[x]    joins x files and sort them, after that the resulting file will be
  75.     written to <outfile>
  76.  
  77. -J[x]    joins x files but they won't be sorted; the resulting file will be
  78.     written to <outfile>
  79.  
  80. -l[y]    using this option one can specify the last line of a range to be
  81.     sorted. if this option is given, ALL actions are done ONLY within
  82.     this range. to give also the first line is not compelling
  83.     if y is bigger than the number of lines of the internal file
  84.     (all in-read files together) the last line is automatically taken
  85.     as last line of the range
  86.  
  87.     if x or/and y is not given it will be asked for
  88.  
  89.  
  90. -n    the file is not sorted, only empty lines are erased.
  91.  
  92. -N    the file is not sorted, only empty lines and lines with the same
  93.     contents which are side by side are erased (of course ONE line is
  94.     kept in the file).
  95.     Note that it might more useful if the file is sorted.
  96.  
  97. -o    the specified file for reading will be overwritten by the sorted
  98.     file. DANGER!!! If once overwritten the original file can't be
  99.     restored!!!
  100.  
  101. -p    all lines, which doesn't match the search pattern will be removed
  102.     the given string may be shorter than the lines, only the length of
  103.     the string will be compared
  104.  
  105. -P    all lines, which match the search pattern will be removed
  106.     see -p
  107.  
  108. -r    the file which was red will only be written in reverse order of lines
  109.  
  110. -s[c]    with this option the character c will be removed from the file.
  111.     note: if characters like " need to be removed it is advisable to give this
  112.     switch as the very last of the command line. Reason is that the following
  113.     arguments are not recognized after a " by the programm.
  114.  
  115. -x    the sorting function will be disabled
  116.  
  117.  
  118. The switches can be set at any place after the program name.
  119. If the parameter to the switch is not given, it will be asked for.
  120. The program detects contradictions between given switches to avoid possible
  121. mistakes from the user
  122.  
  123. Notice that the outfilename has to be the last of all filenames.
  124. If no outfilename is given, the first infilename plus a new ending is used
  125. for a suggestion for the outfilename.
  126.  
  127. The maximum length of a line in a file is 1024 byte.
  128. All bytes that a line is longer than this are cutted. A message appears in
  129. this case. If you need to sort longer lines, just send me a mail.
  130.  
  131. The size of the file to be sorted depends only on the size of the available
  132. memory (and on your patience). The used time is shown after sorting, just
  133. for your statistics ...
  134. I have tested the programm with hundreds of different files and no loss
  135. of data appeared.
  136. I'd be grateful for any comments, suggestions and bug reports.
  137. Well, that's all I can tell about it.
  138.  
  139. planned is to add a feature that one can sort the lines after the 10th or
  140. 13th or whatever char, not only after the first
  141.  
  142. Hope that you can use the program.
  143.  
  144. Rüdiger Werner
  145.  
  146.